This readme.txt file was generated on 2022-09-16 by Estephan J. Moana-Filho, DDS, MS, PhD
Recommended citation for the data: 


-------------------
GENERAL INFORMATION
-------------------


1. Title of Dataset 
Moana-Filho_ChrTMD-stimfMRI-DentoalveolarStim_Database

2. Author Information


  Principal Investigator Contact Information
        Name: Estephan J. Moana-Filho, DDS, MS, PhD
           Institution: University of Minnesota
           Address: 6-320d Moos Tower, 515 Delaware St. SE, Minneapolis, MN 55455-0329
           Email: moana004@umn.edu
	   ORCID: 0000-0001-9642-944X


3. Date published or finalized for release: 2022-09-16

4. Date of data collection: 2016-03 to 2020-02

5. Geographic location of data collection:  Minneapolis, MN, USA

6. Information about funding sources that supported the collection of the data: 
Research reported in this publication was supported by the National Institute of Dental & Craniofacial Research of the National Institutes of Health under Award Number R00 DE027414. The content is solely the responsibility of the authors and does not necessarily represent the official views of the National Institutes of Health. Additional support was provided by the Office of the Vice President for Research, University of Minnesota.

7. Overview of the data (abstract): 
Data files containing partial demographic, clinical characteristics and neuroimaging data for study participants from the “K99 Aim2” research project. 
Results based on these data were published as a pre-print: Peck, C. M., et al. (2022). "Altered Brain Responses to Noxious Dentoalveolar Stimuli in High-Impact Temporomandibular Disorder Pain Patients." medRxiv: 2022.2003.2021.22272709.

--------------------------
SHARING/ACCESS INFORMATION
-------------------------- 


1. Licenses/restrictions placed on the data: TBD

2. Links to publications that cite or use the data: TBD

3. Was data derived from another source? No
           If yes, list source(s):

4. Terms of Use: Data Repository for the U of Minnesota (DRUM) By using these files, users agree to the Terms of Use. https://conservancy.umn.edu/pages/drum/policies/#terms-of-use


---------------------
DATA & FILE OVERVIEW
---------------------


1. File List
   A. Filename: Moana-Filho_ChrTMD-stimfMRI-DentoalveolarStim_Database_2022-09-16.rds       
      Short description: RDS file containing demographic and clinical data (R system native data format)        

   B. Filename: Moana-Filho_ChrTMD-stimfMRI-DentoalveolarStim_Database_2022-09-16.csv        
      Short description: CSV file containing demographic and clinical data (CSV data format)        
        
   C. Filename: Moana-Filho_ChrTMD-stimfMRI-DentoalveolarStim_NeuroimagingData_2022-09-16.zip        
      Short description: Compressed data files for neuroimaging data analysis


2. Relationship between files: NA        


--------------------------
METHODOLOGICAL INFORMATION
--------------------------

1. Description of methods used for collection/generation of data: See pre-print: Peck, C. M., et al. (2022). "Altered Brain Responses to Noxious Dentoalveolar Stimuli in High-Impact Temporomandibular Disorder Pain Patients." medRxiv: 2022.2003.2021.22272709.

2. Methods for processing the data: See pre-print: Peck, C. M., et al. (2022). "Altered Brain Responses to Noxious Dentoalveolar Stimuli in High-Impact Temporomandibular Disorder Pain Patients." medRxiv: 2022.2003.2021.22272709.


3. Instrument- or software-specific information needed to interpret the data: See pre-print: Peck, C. M., et al. (2022). "Altered Brain Responses to Noxious Dentoalveolar Stimuli in High-Impact Temporomandibular Disorder Pain Patients." medRxiv: 2022.2003.2021.22272709.


4. Standards and calibration information, if appropriate: NA


5. Environmental/experimental conditions: See pre-print: Peck, C. M., et al. (2022). "Altered Brain Responses to Noxious Dentoalveolar Stimuli in High-Impact Temporomandibular Disorder Pain Patients." medRxiv: 2022.2003.2021.22272709.


6. Describe any quality-assurance procedures performed on the data: See pre-print: Peck, C. M., et al. (2022). "Altered Brain Responses to Noxious Dentoalveolar Stimuli in High-Impact Temporomandibular Disorder Pain Patients." medRxiv: 2022.2003.2021.22272709.


7. People involved with sample collection, processing, analysis and/or submission: See pre-print: Peck, C. M., et al. (2022). "Altered Brain Responses to Noxious Dentoalveolar Stimuli in High-Impact Temporomandibular Disorder Pain Patients." medRxiv: 2022.2003.2021.22272709.

-----------------------------------------
DATA-SPECIFIC INFORMATION FOR: Moana-Filho_ChrTMD-stimfMRI-DentoalveolarStim_Database_2022-09-16 (RDS and CSV formats)
-----------------------------------------

1. Number of variables: 115


2. Number of cases/rows: 50




3. Missing data codes:
        NA        Definition: Not applicable/available


4. Variable List
                  
Variable names are self-explanatory with appropriate consultation to the methods section of pre-print article: Peck, C. M., et al. (2022). "Altered Brain Responses to Noxious Dentoalveolar Stimuli in High-Impact Temporomandibular Disorder Pain Patients." medRxiv: 2022.2003.2021.22272709.


-----------------------------------------
DATA-SPECIFIC INFORMATION FOR: Moana-Filho_ChrTMD-stimfMRI-DentoalveolarStim_NeuroimagingData_2022-08-31.zip
-----------------------------------------

Neuroimaging data files needed for permutation analysis using the methods section of pre-print article: Peck, C. M., et al. (2022). "Altered Brain Responses to Noxious Dentoalveolar Stimuli in High-Impact Temporomandibular Disorder Pain Patients." medRxiv: 2022.2003.2021.22272709.

These are pre-processed neuroimaging data files (ICA-FIX denoised, MSMAll surface-registered stimfMRI data files for each participant concatenated together), ready for statistical analysis using PALM (https://fsl.fmrib.ox.ac.uk/fsl/fslwiki/PALM). For pre-processing steps please refer to the full description in the pre-print article.

Compressed file with data: Moana-Filho_ChrTMD-stimfMRI-DentoalveolarStim_NeuroimagingData_2022-09-16.zip
Content of compressed files is listed in "4. Variable List"

1. Number of variables: not applicable


2. Number of cases/rows: varies per data file, see description below.


3. Missing data codes: not applicable


4. Variable List: folders and files content included in the compressed file

### Dense analysis: data files at 2 mm smoothing level ###

## Folder: datafiles_dense_GroupAnalysis_01_TaskfMRI-n50
Data files used for between-group comparisons including all participants using F-test and to determine group mean brain activations
                  
Ordering of participants' data in the concatenated file:
# All participants together (participants in order by groups: controls, TMD low-disab, TMD high-disab) - order is important for GLM setup
subjs_grp="GroupAnalysis_01_TaskfMRI-n50"
# subjs list
subjID_list="20001 20002 20004 20005 20006 20008 20010 20011 20012 20013 20015 20016 20017 20018 20019 20021 20022 10001 10002 10004 10005 10006 10007 10009 10011 10013 10014 10015 10018 10019 10021 10022 11004 11006 10012 10016 10023 10024 10030 10031 10033 10034 10035 10037 10038 10039 10041 10042 11009 11015"
##

## Folder: datafiles_dense_GroupAnalysis_06_TaskfMRI-n33_StimsideL
Data files used for between-group comparisons including only participants stimulated in the left side using F-test and to determine group mean brain activations
                  
Ordering of participants' data in the concatenated file:
# All participants with LEFT sided stimulus
subjs_grp="GroupAnalysis_06_TaskfMRI-n33_StimsideL"
# subjs list
subjID_list="20001 20004 20005 20008 20012 20013 20015 20016 20017 20018 10001 10002 10004 10005 10007 10009 10011 10014 10019 10021 10022 11004 10012 10023 10024 10030 10033 10035 10037 10038 10041 11009 11015"
##

## Folder: datafiles_dense_GroupAnalysis_04_TaskfMRI-n17_TMDLowDisab
Data files used for covariate analysis including only chronic TMD low-impact participants
                  
Ordering of participants' data in the concatenated file:
# TMD low pain-related disability
subjs_grp="GroupAnalysis_04_TaskfMRI-n17_TMDLowDisab"
# subjs list
subjID_list="10001 10002 10004 10005 10006 10007 10009 10011 10013 10014 10015 10018 10019 10021 10022 11004 11006"
##

## Folder: datafiles_dense_GroupAnalysis_05_TaskfMRI-n16_TMDHighDisab
Data files used for covariate analysis including only chronic TMD high-impact participants
                  
Ordering of participants' data in the concatenated file:
# TMD high pain-related disability
subjs_grp="GroupAnalysis_05_TaskfMRI-n16_TMDHighDisab"
# subjs list
subjID_list="10012 10016 10023 10024 10030 10031 10033 10034 10035 10037 10038 10039 10041 10042 11009 11015"
##
### End of Dense analysis: data files at 2 mm smoothing level ###

### Parcellated analysis: data files at 2 mm smoothing level ###

## Folder: datafiles_parcellated_HCP-MMP1.0-SIsubregions_MSA_GroupAnalysis_01_TaskfMRI-n50
Data file used for between-group comparisons including all participants using F-test and to determine group mean brain activations
                  
Ordering of participants' data in the concatenated file:
# All participants together (participants in order by groups: controls, TMD low-disab, TMD high-disab) - order is important for GLM setup
subjs_grp="GroupAnalysis_01_TaskfMRI-n50"
# subjs list
subjID_list="20001 20002 20004 20005 20006 20008 20010 20011 20012 20013 20015 20016 20017 20018 20019 20021 20022 10001 10002 10004 10005 10006 10007 10009 10011 10013 10014 10015 10018 10019 10021 10022 11004 11006 10012 10016 10023 10024 10030 10031 10033 10034 10035 10037 10038 10039 10041 10042 11009 11015"
##

## Folder: datafiles_parcellated_HCP-MMP1.0-SIsubregions_MSA_GroupAnalysis_06_TaskfMRI-n33_StimsideL
Data files used for between-group comparisons including only participants stimulated in the left side using F-test and to determine group mean brain activations
                  
Ordering of participants' data in the concatenated file:
# All participants with LEFT sided stimulus
subjs_grp="GroupAnalysis_06_TaskfMRI-n33_StimsideL"
# subjs list
subjID_list="20001 20004 20005 20008 20012 20013 20015 20016 20017 20018 10001 10002 10004 10005 10007 10009 10011 10014 10019 10021 10022 11004 10012 10023 10024 10030 10033 10035 10037 10038 10041 11009 11015"
##

## Folder: datafiles_parcellated_HCP-MMP1.0-SIsubregions_MSA_GroupAnalysis_04_TaskfMRI-n17_TMDLowDisab
Data files used for covariate analysis including only chronic TMD low-impact participants
                  
Ordering of participants' data in the concatenated file:
# TMD low pain-related disability
subjs_grp="GroupAnalysis_04_TaskfMRI-n17_TMDLowDisab"
# subjs list
subjID_list="10001 10002 10004 10005 10006 10007 10009 10011 10013 10014 10015 10018 10019 10021 10022 11004 11006"
##

## Folder: datafiles_parcellated_HCP-MMP1.0-SIsubregions_MSA_GroupAnalysis_05_TaskfMRI-n16_TMDHighDisab
Data files used for covariate analysis including only chronic TMD high-impact participants
                  
Ordering of participants' data in the concatenated file:
# TMD high pain-related disability
subjs_grp="GroupAnalysis_05_TaskfMRI-n16_TMDHighDisab"
# subjs list
subjID_list="10012 10016 10023 10024 10030 10031 10033 10034 10035 10037 10038 10039 10041 10042 11009 11015"
##
### End of Parcellated analysis: data files at 2 mm smoothing level ###
